home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / lan / vlmkt2.zip / ODINSUP.DOC < prev    next >
Text File  |  1994-10-04  |  45KB  |  1,618 lines
  1. This is the readme for ODINSUP.COM.
  2.  
  3. ODINSUP  COM    33867 02-23-93  8:58a version 1.22
  4.  
  5. Modification History:
  6.  
  7.  Changes from v1.01 to v1.10 beta
  8.  
  9.     1. Enhanced to run with Lan Manager 2.0 and 2.1.  These changes made
  10.        to allow code to run with MicroSoft's NetBeui Protocol Stack.
  11.        Use new NET.CFG parameter BUFFERED.
  12.  
  13.     2. Enhanced to allow detection of 386 MicroProcessor for better
  14.        performance.
  15.  
  16.  Changes from v1.10 beta to v1.21
  17.  
  18.     1. Enhanced ODINSUP.COM driver from 1.0 NDIS spec to NDIS v2.0 spec.
  19.  
  20.     2. Fixed a bug in a code path where a variable lacked a CS override.
  21.        Symptom seen (under a heavy load to the AS/400 (ethernet) using 
  22.        PC/SUPPORT the machine would either hang or drop the 
  23.        AS/400 connection).
  24.  
  25. Changes from v1.21 to v2.22
  26.  
  27.     1. Changed the way ODINSUP registers as a default protocol stack.  
  28.        The previous method could cause a potential problem if another 
  29.        default protocol stack registered with the Link Support Layer.
  30.  
  31.  
  32. PURPOSE OF ODINSUP.COM:
  33.  
  34. As part of Novell's commitment to be interoperable, ODI supports NDIS. ODI's
  35. modular architecture allows users to support support NDIS protocol stacks.
  36. A module called ODINSUP.COM allows NDIS protocol stacks to run unmodified
  37. over the ODI LSL and talk to an ODI LAN driver.  Now, multi-vendor network
  38. transports like IBM's NetBEUI, DEC's LAT or 3COM's XNS can be run over a 
  39. common Dat-Link (driver) specification.  For more information, read the 
  40. ODIINFO.DOC file included in this .ZIP file.
  41.  
  42.  
  43. *************************************************************************
  44. *************************NECESSARY CHANGES*******************************
  45. *************************************************************************
  46.  
  47. This section provides a quick reference on all configuration file changes
  48. to be made in order to correctly install ODINSUP.
  49.  
  50.   
  51. ***IMPORTANT***
  52. A working NDIS configuration should already exist on the workstation that
  53. will be configured using ODINSUP.  Then all that needs to be done are 
  54. specific changes to each of the four following files as outlined below:
  55.  
  56. CONFIG.SYS
  57. AUTOEXEC.BAT
  58. PROTOCOL.INI
  59. NET.CFG
  60.  
  61. Although in some cases additional changes may be required, the following 
  62. changes should be sufficient.  Refer to specific examples provided for 
  63. further clarification or if the following changes are not sufficient.  
  64. Note:  NETX and VLMs should be interchangeable in configuring ODINSUP 
  65. (ODI/NDIS interoperability).
  66.  
  67.  
  68. ******CONFIG.SYS******
  69. ---Remark out the NDIS media driver name
  70. ---Set "lastdrive=Z" for VLMs or "lastdrive=?" for NETX, where "?"
  71.    represents the drive letter where separation between NDIS and ODI 
  72.    drives is desired.
  73.  
  74. ******AUTOEXEC.BAT******
  75. ---Load LSL and MLID (ODI driver) that replaces the NDIS driver.
  76. ---Load ODINSUP just after LSL and MLID and before NETBIND.EXE.
  77. ---ODI protocol stacks and Shell (NETX) or Dos Requester (VLMs) 
  78.    should be loaded after NETBIND.EXE and the NDIS protocol stack(s), 
  79.    allowing the ODI protocols to be dynamically unloadable (NDIS stacks 
  80.    are not unloadable).
  81.  
  82. ******PROTOCOL.INI******
  83. ---Change all "Bindings=XXXX" so that the XXXX is the ODI driver
  84.    name (e.g. "X3C503" in place of "ELNKII").  The "X" in front of the 
  85.    3 in 3C503 is necessary since the MLID name begins with a number
  86.    ...not necessary for MLIDs beginning with a letter (e.g. NE2000 or
  87.    TOKEN).
  88.  
  89. ******NET.CFG******
  90. ---Add "Protocol ODINSUP" line at the top of the NET.CFG.  This sets up 
  91.    ODINSUP as the ODI default protocol stack.  Indented on the following 
  92.    line, place the statement "Bind <MLID>" (e.g. Bind 3C503) to specify 
  93.    the driver ODINSUP will bind to.
  94. ---Beneath the Link Driver XXXX section, the following frame types must be 
  95.    specified for Ethernet: Ethernet_802.2, Ethernet_II, and Ethernet_SNAP; 
  96.    for Token-Ring specify: Token-Ring and Token-Ring_SNAP.
  97. ---For NDIS protocol stacks requiring larger receive look ahead data sizes
  98.    than the MLID maximum, the BUFFERED keyword must be placed below the 
  99.    Protocol ODINSUP section.  There is a detection mechanism that should
  100.    report to the user if the "BUFFERED" keyword is needed.
  101.  
  102.  
  103. ***************************************************************************
  104. *****************SUPPLEMENTAL ODINSUP INFORMATION*************************
  105. ***************************************************************************
  106.  
  107. This section provides more detailed information about ODINSUP configuration
  108. and theory.  Also included are a Q & A section followed by several sample 
  109. ODINSUP configurations.
  110.  
  111. Installation of the ODINSUP module is simply a matter of installing it in
  112. memory.  In DOS this is accomplished by loading ODINSUP.COM either at the
  113. command line or in a batch file.  
  114.  
  115. All NDIS MAC Drivers should be replaced on the node with their corresponding
  116. ODI LAN Drivers.  For example, if you were currently using the ELNKII.DOS 
  117. NDIS MAC Driver you would now use the 3C503.COM driver.
  118.  
  119. Configuration of ODINSUP is accomplished by adding statements to the system
  120. NET.CFG.  ODINSUP only needs to be loaded once since it can handle multiple 
  121. ODI LAN Drivers from the same module memory image.
  122.   
  123. The NDIS PROTOCOL.INI file is still necessary to tell the NDIS Protocol(s)
  124. which MAC it should bind to and use.  No ODINSUP specific information is 
  125. necessary in the PROTOCOL.INI file.  However, some MLID information must be
  126. added as detailed above in the "NECESSARY CHANGES" section.
  127.   
  128. At this time ODINSUP will only support Ethernet and Token-Ring compatible
  129. ODI LAN Drivers.  ODINSUP requires that the underlying Ethernet or
  130. Token-Ring ODI LAN Drivers have a number of frame types enabled.  For 
  131. Ethernet ODI LAN Drivers the ETHERNET_802.2, ETHERNET_SNAP, and ETHERNET_II
  132. frames types must be enabled.  For Token-Ring ODI LAN Drivers the TOKEN-RING,
  133. and TOKEN-RING_SNAP frames types must be enabled.  Enabling frame types is 
  134. accomplished by specifying the frame keyword under the appropriate ODI LAN
  135. Drivers section header.  For example:  
  136.   
  137. Sample NET.CFG commands showing enabling of frame types:
  138.   
  139.       link driver ne1000  
  140.          frame ethernet_802.3  
  141.          frame ethernet_802.2  
  142.          frame ethernet_snap  
  143.          frame ethernet_ii  
  144.   
  145. If no binding information is present in the NET.CFG, ODINSUP will attempt to
  146. locate an Ethernet or Token-Ring ODI LAN Driver.  If found, ODINSUP will
  147. attempt to bind to it.  Support for more than one ODI LAN Driver or the need
  148. to explicitly specify which ODI LAN Driver to bind to is accomplished by 
  149. placing binding information in the NET.CFG.  ODINSUP can be bound to a 
  150. maximum of four ODI LAN Drivers.  
  151.   
  152. If the default action of ODINSUP is not desired, binding information should
  153. be placed in the NET.CFG to tell ODINSUP which ODI LAN Drivers it should
  154. bind to.    
  155.  
  156. Bind entries specify the name of the ODI LAN Driver and optionally the   
  157. instance number.  The name of the ODI LAN Driver is normally the name of 
  158. the ODI LAN Driver's file (e.g. NE1000 for NE1000.COM).   The instance
  159. number may be necessary in cases where more than one type of adapter is
  160. installed in the node (e.g. Two 3C523 adapters).  If an instance value is
  161. not specified, ODINSUP will default to the first ODI LAN Driver found
  162. (e.g. If two 3C523 adapters were present, ODINSUP would bind to the first
  163. loaded instance of the ODI LAN Driver). The lowest instance value is 1.
  164.  
  165.   
  166. Sample NET.CFG commands under DOS showing assignment of the instance number:
  167.   
  168.   protocol ODINSUP  
  169.      bind ne1000   ;Bind to the first instance of the NE1000 ODI LAN Driver
  170.      bind 3c523 2  ;Bind to the second instance of the 3C523 ODI LAN Driver
  171.      bind token 1  ;Bind to the first instance of the TOKEN ODI LAN Driver
  172.  
  173.  
  174. OTHER SAMPLE FILES
  175.  
  176. AUTOEXEC.BAT:
  177.   
  178.       lsl  
  179.       3c503  
  180.       ODINSUP  
  181.   
  182.       ...Load NDIS Protocols if not loaded in CONFIG.SYS  
  183.   
  184.       netbind  
  185.     
  186.       ...Load ODI Protocols  
  187.   
  188.  
  189. The PROTOCOL.INI must specify sections for each NDIS protocol used.  Part of
  190. this information is the Bindings statement which